4D Doc Center : CT EVENT FILTER

4D Chart v13

CT EVENT FILTER


CT EVENT FILTER ( area ; filter )

Parameter	Type	Description
area	Longint	4D Chart area
filter	Longint	Events to process

Description

The CT EVENT FILTER command specifies which events cause the object method of area or the event method to be executed.

By default, an object method attached to a 4D Chart area is executed when the user selects an object outside of the area. With CT EVENT FILTER you can specify other events that execute the method. In addition, a method installed with the CT ON EVENT command will also be executed.

filter specifies the events to use, expressed as the sum of event codes. The following are the event codes:

Value	Event
-1	All events
0	No events
1	Area creation
2	Area deletion
4	Area activated (clicked or brought to the front)
8	Area deactivated (area is no longer active)
16	Object creation (create, paste, duplicate)
32	Object deletion (delete, cut, clear)
64	Ctrl+Click (Windows) or Command-click (Macintosh), not necessarily on object
128	Object was moved (nudge, alignment, move, etc.)
256	Object was resized (arrow keys, drag, etc.)
1024	Change in selected object(s)
2048	Double-click
4096	Object was reshaped

If you specify -1 for area, the event filter becomes the default filter for all newly created 4D Chart areas on forms and in plug-in windows. This allows you to trap for areas created from the Plug-ins menu of the User environment. It also allows for consistent event handling in all areas.

Example

This example adds Ctrl+click (under Windows) or Command+click (under MacOS) and double-click to the list of default events trapped by the chart area’s object method.

CT EVENT FILTER(Area;64+2048)